HBuilderX Windows 启动问题排查指南

此帖子为windows解决方案，mac请参考：mac解决方案

windows的zip包，解压时间比较长，请勿中断！ 如中断了解压，请重新解压

Windows HBuilderX起不来，主要有两种：

近来，部分小伙伴，反馈在windows系统上，新下载的HBuilderX，解压后，无法启动、点击无反应、启动报xxx.dll错误。

特别备注：HBuilderX，要求系统最低是win7，不支持xp

特别说明： 如果您的电脑AMD显卡，请直接看第6章节

有的小伙伴，从DCloud.io下载zip包，双击后，在压缩软件里，点击HBuilderX.exe

这种是不对的，zip包需要解压才能使用

windows, 部分小伙伴，解压zip后，为了创建快捷方式，把HBuilderX.exe直接拖动到桌面了，点击exe启动不了。

创建桌面快捷方式的正确姿势：

尝试以下解决方案

备注： 如果此方法，没有解决您的问题，请看下【事件查看器】中的错误。关于事件查看器，请查看章节3

如遇到内存不能read的问题，请自行百度搜索相关方法

如果您的电脑安装过qt程序，可能会遇到下列问题

解决方案

方法1： 解压后，进入HBuilderX目录，进入bin目录，将bin目录下，所有除了api开头的dll文件，就是非api开头的dll文件，剪切到上一级目录。注意是剪切，不是复制。

方法2：进入HBuilderX目录下bin目录，找到弹框里面提到的dll文件，然后拷贝到System32或者SysWOW64文件夹

方法3：检查一下本机是否安装了qt，如以前安装过，进入环境变量，将qt相关的环境变量删除

如下图：

解决方案：检查一下本机是否安装了qt，如以前安装过，进入环境变量，将qt相关的环境变量删除

如果以上的方案都没有解决您的问题，那就需要仔细查找原因了。

某些错误，会记录在【事件查看器】中。

打开事件查看器的方法： 点击“开始→运行”，输入eventvwr，点击“确定”，就可以打开事件查看器。

如下图： 点击【Windows 日志】—【应用程序】，找到级别为错误的记录，如是HBuilderX的记录，根据记录，解决问题

特别说明：如果事件查看器错误显示unKnow, 那就下载此 opengl32sw.dll文件补丁，放到HBuilderX根目录试试

下面罗列，【事件查看器】中可能会遇到的错误

在事件查看器中，可能遇到ig9icd32.dll错误的解决办法

方法1：升级显卡驱动

方法2：下载此 opengl32sw.dll文件补丁, 下载后，将此dll文件，放到HBuilderX安装目录的根目录

在事件查看器中，可能遇到dbgcore.dll错误的解决办法

下载补丁文件 dbgcore.dll下载地址, 下载后，将此dll文件，放到HBuilderX安装目录的根目录

注意：也有可能是配置文件损坏了。参考4章节。

如果您的电脑配置了AMD显卡，如遇到启动问题（事件查看器atioglxx.dll错误），atioglxx.dll是ati显卡驱动所需要的一个文件。

解决办法：

部分类型的显卡，可能因为

如果您更新过显卡驱动， 更新驱动之后，启动不了。那就是显卡驱动的问题。请还原显卡驱动，或升级驱动到最新版、或最新稳定版本。

还有小伙伴反应，昨天还用的好好的，今天启动不了，怎么回事呢？

新下载的小伙伴，也有可能遇到这个问题。

有可能是配置文件损坏了，导致无法启动。

在操作系统资源管理器地址栏输入%appdata%回车； 在此目录下，找到HBuilder X目录，打开。

进入后，如发现存在.lock文件，删除此文件，然后尝试启动HBuilderX。

部分用户反馈，启动后，部分笔记本顶部工具栏显示不全

原因：在部分笔记本电脑上，因为分辨率或缩放的原因，HBuilderX启动顶部菜单显示不全。

解决方法：

如果以上都尝试了，还未解决，请联系官方：

如果您遇到启动问题，发邮件、或添加qq寻求帮助时，请您提供下列信息，这样可以得到更快帮助！

需要提供的信息：

若有收获，就点个赞吧

0 人点赞